home *** CD-ROM | disk | FTP | other *** search
/ IRIX 6.5 Complementary Applications 2004 February / SGI IRIX 6.5 Complementary Applications 2004 February.iso / dist / cde.idb / usr / dt / share / man / cat3 / XmStringGetNextComponent.z / XmStringGetNextComponent
Encoding:
Text File  |  2003-11-18  |  6.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       _X_m_S_t_r_i_n_g_G_e_t_N_e_x_t_C_o_m_p_o_n_e_n_t - A compound    string function    that
  10.       returns the type and value of    the next component in a
  11.       compound string
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.       #include <Xm/Xm.h>
  15.  
  16.       XmStringComponentType    XmStringGetNextComponent (ccccoooonnnntttteeeexxxxtttt,,,, tttteeeexxxxtttt,,,, ttttaaaagggg,,,, ddddiiiirrrreeeeccccttttiiiioooonnnn,,,, uuuunnnnkkkknnnnoooowwwwnnnn____ttttaaaagggg,,,,
  17.       uuuunnnnkkkknnnnoooowwwwnnnn____lllleeeennnnggggtttthhhh,,,, uuuunnnnkkkknnnnoooowwwwnnnn____vvvvaaaalllluuuueeee)
  18.            _X_m_S_t_r_i_n_g_C_o_n_t_e_x_t       ccccoooonnnntttteeeexxxxtttt;
  19.            _c_h_a_r           **tttteeeexxxxtttt;
  20.            _X_m_S_t_r_i_n_g_C_h_a_r_S_e_t       *ttttaaaagggg;
  21.            _X_m_S_t_r_i_n_g_D_i_r_e_c_t_i_o_n   *ddddiiiirrrreeeeccccttttiiiioooonnnn;
  22.            _X_m_S_t_r_i_n_g_C_o_m_p_o_n_e_n_t_T_y_p_e*uuuunnnnkkkknnnnoooowwwwnnnn____ttttaaaagggg;
  23.            _u_n_s_i_g_n_e_d    _s_h_o_r_t       *uuuunnnnkkkknnnnoooowwwwnnnn____lllleeeennnnggggtttthhhh;
  24.            _u_n_s_i_g_n_e_d    _c_h_a_r       **uuuunnnnkkkknnnnoooowwwwnnnn____vvvvaaaalllluuuueeee;
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.       _X_m_S_t_r_i_n_g_G_e_t_N_e_x_t_C_o_m_p_o_n_e_n_t returns the type and    value of the
  28.       next component in the    compound string    identified by ccccoooonnnntttteeeexxxxtttt.
  29.       It is    a low-level component function.     Components are
  30.       returned one at a time.  On return, only some    output
  31.       parameters will be valid; which ones can be determined by
  32.       examining the    return status.    In the case of tttteeeexxxxtttt, ttttaaaagggg, and
  33.       ddddiiiirrrreeeeccccttttiiiioooonnnn components,    only one output    parameter is valid.
  34.       If the return    status indicates an unknown component was
  35.       encountered, the font    list element tag, length, and value
  36.       are returned.     This function allocates the space necessary
  37.       to hold returned values; freeing this    space is the caller's
  38.       responsibility.
  39.  
  40.       ccccoooonnnntttteeeexxxxtttt
  41.            Specifies the string context structure which was
  42.            allocated by the    _X_m_S_t_r_i_n_g_I_n_i_t_C_o_n_t_e_x_t function.
  43.  
  44.       tttteeeexxxxtttt Specifies a pointer to a    null terminated    string.
  45.  
  46.       ttttaaaagggg  Specifies a pointer to the font list element tag
  47.            associated with the text.  The value
  48.            _X_m_F_O_N_T_L_I_S_T__D_E_F_A_U_L_T__T_A_G identifies a locale text
  49.            segment.
  50.  
  51.       ddddiiiirrrreeeeccccttttiiiioooonnnn
  52.            Specifies a pointer to the direction of the text.
  53.  
  54.       uuuunnnnkkkknnnnoooowwwwnnnn____ttttaaaagggg
  55.            Specifies a pointer to the tag of an unknown component.
  56.  
  57.       uuuunnnnkkkknnnnoooowwwwnnnn____lllleeeennnnggggtttthhhh
  58.            Specifies a pointer to the length of an unknown
  59.            component.
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/11/03)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXXUUUU))))NNNNIIIIXXXX SSSSyyyysssstttteeeemmmmXXXXVVVVmmmmSSSSttttrrrriiiinnnnggggGGGGeeeettttNNNNeeeexxxxttttCCCCoooommmmppppoooonnnneeeennnntttt((((3333XXXX))))
  71.  
  72.  
  73.  
  74.       uuuunnnnkkkknnnnoooowwwwnnnn____vvvvaaaalllluuuueeee
  75.            Specifies a pointer to the value    of an unknown
  76.            component.
  77.  
  78.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  79.       Returns the type of component    found.    Following are the
  80.       possible values:
  81.  
  82.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__C_H_A_R_S_E_T
  83.  
  84.       This component is obsolete and remains for compatibility
  85.       with previous    releases.  It has been replaced    by
  86.       _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__F_O_N_T_L_I_S_T__E_L_E_M_E_N_T__T_A_G.
  87.  
  88.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__F_O_N_T_L_I_S_T__E_L_E_M_E_N_T__T_A_G
  89.  
  90.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__L_O_C_A_L_E__T_E_X_T
  91.  
  92.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__T_A_G
  93.  
  94.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__T_E_X_T
  95.  
  96.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__D_I_R_E_C_T_I_O_N
  97.  
  98.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__S_E_P_A_R_A_T_O_R
  99.  
  100.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__E_N_D
  101.  
  102.       +o    _X_m_S_T_R_I_N_G__C_O_M_P_O_N_E_N_T__U_N_K_N_O_W_N
  103.  
  104.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  105.       _X_m_S_t_r_i_n_g_C_r_e_a_t_e(_3_X) and _X_m_S_t_r_i_n_g_I_n_i_t_C_o_n_t_e_x_t(_3_X).
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                        (printed 11/11/03)
  130.  
  131.  
  132.  
  133.